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PREFACE 



The purpose of this manual is to provide users of UTIL, FMP, and COPYL with a 
description of the external features and operating instructions of each package. 
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This reference manual describes the use and operation of the MPX utility package, which 
consists of the following: 



• File Maintenance Package (FMP) 
%J • Input/Output Utility Package (UTIL) 

^Mt • Load File Editor Program (COPYL) 

The MPX utility programs are contained on the MPX library, with individual services 

©being called into execution by the reading of card image control statements from the 
standard input device. Unless specifically noted, the standard input device is a card 
reader. 

Operator familiarity with the MPX/RT operating system is assumed. 

In the following descriptions, control statements begin with an asterisk in column 1 of the 
input card. The request code begins in column 2 and is followed by the required param- 
eter. All fields are separated by commas or parentheses. 
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FILE MAINTENANCE PACKAGE 



The FMP provides a comprehensive set of mass storage utility routines, which allow the 
operator to do the following: 

• Maintain device labels 

• Maintain file labels 

• List selected portions or all of the file label directory 

• List selected portions or all of the device label directory 

• Write files from disk to magnetic tape 

• Reload files from magnetic tape to disk 

The FMP package is called by the MPX/RT job processor after reading an *FMP statement 
from the standard input device. The package is loaded, and control statements are pro- 
cessed from the standard input device. Processing continues until an *OUT control 
statement is read, at which time control is returned to the MPX monitor. 

CONTROL STATEMENTS PROCESSED BY FMP 

The functions provided by FMP are as follows: 



• *FLD 

• *DLD 

• *ENTER 

• *DUMP 

• *LOAD 

• *VERIFY 



List file label directory 

List device label directory 

Write a device label and format a disk pack 

Write file(s) from disk to magnetic tape 

Write file(s) from magnetic tape to disk 

Compare dump tape file(s) with disk file(s) 
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In the description of the FMP control statements, the following mnemonics will be used. 
Parameters not included in this list must be on the control statement as the alphabetic 
character specified. 



• AK 

• DID 

• DT 



• ED 






FMPAK 



FN 
LUN 



• OWNER 



One to four characters specifying the access privacy key for 
a file identified by FN, ED, and OWNER 

One- to eight-character device identifier 

A one-character number specifying the type of disk: 

1 = 9425 

2 = 844 

3 = 9427 

4 = 9760 or 858 

5 = 640 

Two characters specifying the edition number of a file with 
the same FN and OWNER. 

A master access privacy key, which will allow FMP 
routines access to files regardless of the AK of the files. 
Refer to the MPX-RT Systems Installation Handbook 
(Control Data publication No. 14064000) for this master 
access privacy key. 

One to 14 characters specifying a file name. 

One- or two-digit logical unit number of a magnetic tape, 
which has been opened prior to execution of the *FMP 
control statement. 

One to four characters specifying the file owner. 
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'FMP 
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This control statement is read by the MPX operating system and causes the FMP to be 
loaded and placed in operation. Upon being placed in operation, FMP will recognize only 
those control statements listed in the previous paragraph. All MPX control statements 
must precede the *FMP statement or follow the *OUT statement. 

All messages and errors will be reported on the standard output device. 
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List all file labels of files that have an owner and access key matching the OWNER 

©and AK in the control statement. If FMPAK is used for the AK field, all file 
labels that match OWNER will be listed. 
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*FLD LIST FILE LABEL DIRECTORY 

Listing of the FLD is possible by listing all or selected portions. The control statement 
options are as follows: 

• *FLD,A,FMPAK 

List all file labels in the label file. 

• *FLD.O,OWNER,AK 



• *FLD,F,FN,OWNER,ED,AK 

List the file label for the file that matches the FN, OWNER, ED, and AK. If the 
field ED contains **, a file label is listed for each edition. 

The two FLD listing formats are fixed and variable length. The fixed length portion is 
first and is listed as follows: 

FILENAME FFF. . . FFF 

EDITION EE 

OWNER 0000 

USAGE READ ONLY or READ/WRITE 

NUMBER OF ALLOCATED BLOCKS XXXXX 

HIGHEST BLOCK WRITTEN XXXXX 

BLOCK SIZE IN WORDS XXXXX 

NUMBER OF SECTORS PER BLOCK XXXXX 

DEVICE TYPE DDDD 

NUMBER OF DEVICES XXXX 

NUMBER OF SEGMENTS XXXX 
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The variable length portion is second and is listed as follows: \j 

• For each device DEVICE IDENT DDDDDDDD ^^ 

o 

o 
o 
o 
c 

o 



• For each segment SEGMENT 

SECTOR ADDRESS 
NUMBER OF SECTORS 



*DLD LIST DEVICE LABEL DIRECTORY 

Listing of the DLD is possible by listing all or selected portions. The control statement 
options are as follows: 

• *DLD,A,FMPAK 
List all device labels from the label file. 

• *DLD, D, DID, .... DID 

Up to eight on-line device identifiers may be specified. The device labels for the 
specified DIDs will be listed. 



• *DLD,0,DT,DID ^ 

List the device label for the on-line device specified by DT and DID. (f^) 

The following information is listed for each device. 

DEVICE IDENT DDDDDDDD 

DEVICE DDDD 

SECTOR SIZE(WORDS) XXXX 

TRACK SIZE(SECTORS) XXXX 

DEVICE SIZE (TRACKS) XXXX {Q 

The following information is listed for each assigned or unassigned segment on the device. --^ 

TRACKS XXXX THRU XXXX USED or UNUSED 
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Q *ENTER WRITE DEVICE LABEL AND FORMAT 

&\ The *Enter control statement is a service function to prepare disk packs for use in the 

*** MPX operating system. Functions performed are as follows: 

(t\ • Writing a device label on a new pack 



© 



• 



Relabeling an existing pack 

Clear by writing zeros on the pack 



^y With the *ENTER statement in execution, the FMP routine examines the device type and 

requests the operator (at the operator console) to mount the pack to be entered on the 

©available disk drive. Upon acknowledgement from the operator, the function is performed 
on the assigned disk pack. 



Of special note: 



• Whenever the *ENTER statement is performed, all previously written information 
on the disk pack is no longer available to the system. 

• Whenever the C parameter (clear) is selected and an irrecoverable write occurs 
for a track, the track is downed and not available to the system. 



© 



The control statement and its functions are as follows: 
© *ENTER,DT,DID,C 

©Write a device label, DID, on the disk pack of the device type specified by DT and clear 
previous information by writing zeros. If the C paramenter is absent, zeros are not 
written. Previously written information is not available to the system. 

o 

%P The primary purpose of the *DUMP control statement is to retain system or user files 

on magnetic tape as backup to the disk pack. The magnetic tape to be used must be 
JP| equipped and assigned to the system prior to the *FMP control statement. 

The *DUMP statement writes the label of each file to be dumped on the specified magnetic 
A tape unit. Following the header, each track of the file is dumped by blocks. When the 

v entire file has been dumped, an end-of-file is written. The file and header are written 

in biary on the magnetic tape, with the header containing the file allocation parameters. 
Mk This method allows a number of files to be dumped onto the same magnetic tape. 

The control statement options are as follows: 



"DUMP WRITE FILE(S) FROM DISK TO MAGNETIC TAPE 
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*DUMP, O, LUN, OWNER, FMPAK, R 

o 

Dump all the files having the specified OWNER to tape. The parameter R is 
optional. If present, the file(s) is released after the dump is complete. The 
file(s) must be released if it is to be allocated by the *LOAD control statement. lO 

*DUMP, F, LUN, FN, OWNER, ED, AK, R, DWN „ 

c 

Dump the file specified by FN, OWNER, ED, and AK to tape. The parameter R 

is optional. If present, the file is released after the dump is complete. The ^~. 

file must be released if it is to be allocated by the *LOAD control statement. \y 

The parameter DWN is optional. The parameter R must be present when DWN 

is specified. If DWN is specified, the bad tracks encountered during the dump *-^ 

are marked assigned in the labels of the device containing the bad tracks. \jl 



At the completion of the dump, the following information will be placed on the standard 
oulput device. 



The control statement format is as follows: 

• *IDENT,DT,DID 

Allocate the files on the DT and DIDs specified. 1-8 DIDs may be specified 
separated by commas. Both parameters must be present. 

• *IDENT 

This form of the statement restores *LOAD to allocate files as specified on the 
dump tape. 

*LOAD WRITE FILE(S) FROM MAGNETIC TAPE TO DISK 

The *LOAD control statement transfers a file(s) to a mass storage file(s) from a magnetic 
tape produced by *DUMP. The use of the R and NS parameters allows for releasing 
segmented files and reallocating them as non-segmented files. 

,2-6 14063800 B 






FID = file name, owner, edition 
FILE DUMPED 

* IDENT IDENTIFY NEW DT AND/OR DID FOR "LOAD STATEMENT \*J 

The primary purpose of the *IDENT control statement is to identify a new device type {f~\ 

and/or device identifier on which to allocate files during the *LOAD processing. Files V/ 

written in blocker-deblocker format may be moved across both device type and device 
identifier. Files not written in blocker-deblocker format, such as RESFILE, may only 
be moved across device identifiers. 



c 
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f\ The control statement options are as follows: 

• *LOAD,A,LUN,FMPAK,R,NS 

O 

Load all the files to disk from the tape unit specified by LUN. The parameter R 

is optional. If R is specified, the same existing files on disk are released and 
tfj reallocated before loading begins. The parameter NS is optional and is meaning- 

ful only when R is specified. If NS is specified, the files are allocated with no 
segmentation allowed. 
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*LOAD, F, LUN, FN, OWNER, ED, AK,R, NS 



f^ Load the file specified by FN, OWNER, ED, and AK from the tape unit LUN to 

disk. When more than one file exists on the tape, the tape will be searched 
^p,^ until the correct file is found. The parameter R is optional. If R is specified, 

^J the same existing file on disk is released and reallocated before loading begins. 

The parameter NS is optional and is meaningful only when R is specified. If 
NS is specified, the file is allocated with no segmentation. 



At the completion of the load, the following information will be placed on standard output 
device. 

FID = File name, owner, edition 

FILE LOADED 

"VERIFY COMPARE FILE(S) ON TAPE WITH DISK FILE(S) 

The *VERIFY control statement compares a file(s) on magnetic tape, created from the 
*DUMP control statement, with the corresponding file(s) on disk. 

The control statement and its functions are as follows: 

* VERIFY, LUN 

Verify all files on the dump tape as specified by LUN with the corresponding files on disk. 

At the completion of the verify, the following information will be placed on the standard 
output device. 

FID = File name, owner, edition 

FILE VERIFIED 

All errors are reported on the standard output unit. 
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Error Message 


Cause 


Action 


o 

o 


IRRECOVERABLE ERROR 
OCCURRED WHILE READING/ 
WRITING BLOCK XXXXX 
FROM/TO DISK/TAPE 


Error occurred on block XXXXX 
during a load or dump request. 


Processing 
continues. 


LABEL FILE READ ERROR, 
BLOCK NUM = XXXXX 


Error occurred while reading 
the label file. 


Processing 
continues. 


LOAD TAPE IS NOT IN 
FMP FORMAT 


Load tape was not created by 

FMP. 


FMP skips to 
next control 
card. 


1^1 


NO FILES/DUMP/LOADED 


No files specified by the load 
or dump request were found in 
the label file (dump) or on the 
load tape. 


FMP skips to 
next control 
card. 


FMP ABNORMALLY 
TERMINATED 


An error causes FMP to abort 
processing. 


FMP aborts 
processing. 





BAD TRACK, TRACK 

NUM = 


In processing the *ENTER 
request, an error occurs. 


Mark track 
assigned. 
Processing 
continues. 


• 
o 
o 




CANNOT WRITE DEVICE 
LABEL 

***OPEN ERRORXX 


Error occurred in writing the 
device label. 

OCARM ERROR XX occurred 
on a dump or load request. 


FMP skips to 
next control 
card. 

FMP aborts 
processing. 


***CLOSE ERRORXX 


OCARM ERROR XX occurred 

on a dump or load request. 


FMP aborts 
processing. 





***MODIFY ERRORXX 


OCARM ERROR XX occurred 
on a load request. 


FMP aborts 
processing. 


^r 


***RELEASE ERRORXX 


OCARM ERROR XX occurred 
on a dump or load request. 


FMP aborts 
processing. 


#1 


***ALLOCATE ERRORXX 


OCARM ERROR XX occurred 

on a load request. 


FMP aborts 
processing. 
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Error Message 

***DEVICE CANNOT BE 
PLACED ONLINE 



Cause 

Operator cannot place the device 
on-line, or a mass storage unit 
is not available. 



Action 

FMP skips to 
next control 
card. 



The OCARM ERROR codes (XX) are defined in the MP-60 MPX/RT Reference Manual, 
Control Data publication No. 14062300. 



JOB STRUCTURE EXAMPLES 

FMP job structure examples are as follows: 
• List the contents of the label file 
*JOB (...) 
*SCHED (...) 
*FMP 

*FLD,A,FMPAK 
*OUT 
*EOJ 
"* • List the label of a specific file 
*JOB (...) 
*SCHED (...) 
*FMP 

*FLD, F, FILE-NAME, OWNR, 01,**** 
*OUT 
*EOJ 



o 
o 
o 
o 
o 
o 
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f\ • List the device label directory 

*JOB (...) 
© 

© 

O 

O 



*SCHED (...) 
*FMP 

*DLD,A,FMPAK 
*OUT 
*EOJ 
• Dump files from disk to tape and verify 
*JOB (...) 
Q *SCHED (...) 

C*EQUIP (10=MT) 
*FMP 
*DUMP ,0,10, OWNR , FMPAK 
— . *VERIFY, 10 

*OUT 
© *EOJ 

O 

© 
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INPUT/OUTPUT UTILITY PACKAGE (UTIL) 

o 
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The I/O utility package (UTIL) enables the operator to perform the following functions on 
peripheral hardware devices such as the disk, magnetic tape, card reader, line printer, 
and card punch. 

• Transfer information between two devices 

• Verify information between two devices 

• Motion control 

The UTIL program is called by the MPX/RT job processor on reading a *UTIL statement 
from the standard input device. The utility routine accepts request statements from the 
standard input device. The program continues processing requests until terminated by an 
*OUT statement, at which time control is returned to the MPX monitor. 

When an end-of-file condition (*EOJ) is detected on the card reader, disk files are closed 
and the UTILITY program returns to the job monitor. The user can use the *ENDFILE 
control card, which is treated as end-of-file records when processing UTIL request 
statements. 

Binary records are transferred to the printer as "BINARY RECORD." If no spacing 
control is requested, character 1 of each record is assumed to contain a print control 
character. When single or double spacing is specified, the first 135 characters of the 
output record are printed, preceded by the required print control character. 

The messages "UTILITY IN" and "UTILITY OUT" are transferred to the printer at 
initialization and termination of UTILITY. Upon completion of each transfer and verify 
request, the number of files and records is outputted to the standard output device in the 
following message: 

FILES NN RECORDS MM COMPLETE 

UTIL uses BLKDEBLK for creating blocked tapes; refer to the MPX/RT Reference Manual, 
Control Data publication No. 14062300, for a description of the headers and data areas 
(page 6-2). The magnetic tapes created are compatible with ANSI standards. The user 
determines the format of unblocked tapes by specifying the record length. 



14063800 



3-1 



CONTROL STATEMENTS PROCESSED BY UTIL 



*V Verify information, on a record-by-record basis, between the following 
peripheral devices. 
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The functions provided by UTIL are as follows: m~\ 

• *T Transfer information from one peripheral device to another 

o 

a) Card to card 

b) Card to tape |TJ) 

c) Card to printer 

G 

d) Cards to disk file 

e) Tape to tape ^J 

f) Tape to card ^-^ 

g) Tape to printer 
h) Tape to disk file 
i) Disk file to disk file 
j) Disk file to card 

k) Disk file to tape sLy 

1) Disk file to printer g-^ 



if x - 



a) Card versus tape 

b) Card versus card ( two card readers required) 

c) Card versus disk file 

d) Disk file versus disk file 

e) Disk file versus tape 

f) Tape versus tape fh 



c 
c 
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o 

o 
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• Motion is controlled by the following statements. 

a) *REW Rewind magnetic tape or disk file 

b) *EOF Write end-of-file 

c) *ADF Advance logical unit 

d) *BSF Backspace logical unit N files 

e) *BSR Backspace logical unit N records 

In the description of the UTIL control statements, the following mnemonics will be used. 

• Ul One- or two-digit input logical unit number 

• U2 One- or two-digit output logical unit number 

The parameter fields for logical units Ul and U2 must be previously equipped to physical 
devices using EQUIP cards, or ALLOCATE and OPEN if the units are on disk, before 
UTIL is called. 

Logical units Ul and U2 cannot be equal, and two different logical units cannot be 
equipped to the same physical unit in a UTIL request, except for disk. 

If an output unit is not defined, it is interpreted as a dummy unit used to reposition the 
input file by the given number of records or files. Codes are as follows: 



• B/blank 

• Block length 

• Max records 



B = blocked type 

Blank or not B = unblocked tape 

Length of tape record or block 

Sets an upper limit on the number of records to be transferred. 
If N is omitted, records are transferred until the number of 
files in the next parameter has been reached. The upper 
limit of number of records to be transferred is in decimal. 
At the end of the transfer, the number of records and files 
encountered are outputted to the standard output device. Max 
records would be specified only when a given number of 
records of a file are to be transferred. 



14063800 



3-3 



o 
o 
o 

• Max files Sets an upper limit on the number of files to be transferred. 4T\ 

If it is omitted, one file is transferred or the number of 

records specified by max records are transferred. The 

upper limit of the number of files to be transferred is in Bjt 

decimal. At the end of the transfer, the number of records 

and files encountered is placed on the standard output _ 

device. Max files would be specified only when a given m~m 

number of complete files are to be transferred. 

• Spacing Used only when the output unit is the printer; double space J|JS 

if field is D, and single space if field is S. If spacing is 
not specified, forms control is provided by the first 
character of each record. 



TRANSFER INFORMATION 

The following are the individual transfer request formats. Standard blocked tapes are 
generated using the system blocker/deblocker package. In all requests involving tapes, 
the tape may be unblocked with the record length given or blocked using a specified block 
length. 

NOTE: 

The system standard block length is 480 words. 



Transfer information from card reader, logical unit Ul, to magnetic tape, 
logical unit U2. 

• Card to card 

*T,U1,U2,MAX RECORDS, MAX FILES 

Transfer information from card reader, logical unit Ul, to card punch, logical 
unit U2. 

• Card to printer 

*T,U1,U2,MAX RECORDS, MAX FILES.SPACING 

Transfer information from card reader, logical unit Ul, to printer, logical unit U2. 
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Card to tape 

*T,U1,U2,B/BLANK, BLOCK LENGTH, MAX RECORDS, MAX FILES f^ 



c 
c 

o 



o 
o 



o 

^^ • Tape to card 

*T,U1, B/BLANK, BLOCK LENGTH, U2, MAX RECORDS, MAX FILES 

o 
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Transfer information from magnetic tape, logical unit Ul, to card punch, logical 
unit U2. 

• Tape to printer 



{% *T, Ul, B/BLANK, BLOCK LENGTH, U2, MAX RECORDS, MAX FILES, I 

SPACING 

^J Transfer information from magnetic tape, logical unit Ul, to printer, logical unit 

U2. 



• Tape to tape 

*T, Ul, B/BLANK, BLOCK LENGTH, U2, B/BLANK, BLOCK LENGTH, MAX RECORDS, 
MAX FILES 

Transfer information from magnetic tape, logical unit Ul, to another magnetic tape, 
logical unit U2. 

• Disk file to tape 

*T,U1,U2, B/BLANK, BLOCK LENGTH, MAX RECORDS, MAX FILES 

Transfer information from disk file, logical unit Ul, to magnetic tape, logical 
unit U2. 



• Disk file to card 
*T,U1,U2,MAX RECORDS, MAX FILES 
Transfer information from disk file, logical unit Ul, to card punch, logical unit U2. 

• Disk file to printer 

4% *T,U1,U2, MAX RECORDS, MAX FILES, SPACING 

Transfer information from disk file, logical unit Ul, to printer, logical unit U2. 

• Card to disk file 

^ *T,U1,U2,MAX RECORDS, MAX FILES 

Transfer information from card reader, logical unit Ul, to disk file, logical unit U2. 
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• Tape to disk file 

*T,U1,B/BLANK, BLOCK LENGTH, U2, MAX RECORDS, MAX FILES (T\ 



Transfer information from magnetic tape, logical unit Ul, to disk file, logical 
unit U2. 

• Disk file to disk file 

*T,U1,U2,MAX RECORDS, MAX FILES 

Transfer information from disk file, logical unit Ul, to another disk file, logical 
unit U2. 

VERIFY REQUESTS 



o 

© 

o 

o 

The verify request function permits the verification of information on a record- by- record 

basis. Some peripheral devices, such as the card punch and printer, cannot be used to ^-^ 

verify information because they are incapable of input. ' 

In the individual verify request formats that follow, the parameter field notations are the 

same as for transfer requests, except that Ul is defined as the logical unit read first \y 

and U2 as the logical unit read second. 






The number of records and files verified are outputted to the standard output device at 
completion of the request. If two corresponding records do not compare, the file and 
record numbers are outputted to the standard output device. 

• Card versus tape 

*V,U1,U2,B/BLANK, BLOCK LENGTH, MAX RECORDS, MAX FILES ^ 

NOTE |f"\ 

If tape is logical unit Ul, then block format and 

length must directly follow the logical unit Ul «o 

parameter. 

• Card versus card M J) 
*V,U1,U2,MAX RECORDS, MAX FILES 

NOTE 
Two card readers are required. 
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• Tape versus tape 

*V,U1, B/BLANK, BLOCK LENGTH, U2, B/BLANK, BLOCK LENGTH, MAX RECORDS, 
MAX FILES 

• Disk file versus tape 

*V,U1,U2, B/BLANK, BLOCK LENGTH, MAX RECORDS, MAX FILES 

NOTE 



©If the tape is logical unit Ul, then block format and 
length must directly follow the logical unit Ul 
parameter. 



■ J • Card versus disk file 

*V,U1,U2,MAX RECORDS, MAX FILES 
• Disk file versus disk file 

*V,U1,U2,MAX RECORDS, MAX FILES 



MOTION CONTROL REQUESTS PROVIDED BY UTIL 

Motion control requests provided by UTIL are as follows: 

• *REW,U REWIND 

For magnetic tape, rewind logical unit U to the load point. 
For disk, set the pointer to the first block of file U. 

• *EOF,U,N 

For magnetic tape, write N end-of-file records on device U. If no N parameter 
is specified, 1 is assumed. 

For disk, this is a no operation (NOP). 

• *ADF,U,N 



M^k For magnetic tape, advance logical unit U forward N files. If no N parameter is 

given, l is assumed. If from the load point, advance forward logical unit U to 
the beginning of file N. 
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For disk, set the pointer to the highest block written + 1. The N parameter is 
ignored. 

• *BSF,U,N 

For magnetic tape, logical unit U should be backspaced N files. If no N parameter 
is given, l is assumed. 

For disk, set the pointer to the first block of file U. 

• *BSR,U,N 

For magnetic tape, logical unit U should be backspaced N records (blocks). If 
no N parameter is given, 1 is assumed. 

For disk, set the pointer backward N blocks. If no N parameter is given, 1 is 
assumed. 

There is no specialized request to advance a logical unit N records, but the function can 
be performed using a TRANSFER request and an output logical unit that is not assigned. 

UTIL ERROR MESSAGES AND RECOVERY PROCEDURES 



All errors are reported on the standard output device. 



Error Message 
INVALID REQUEST 



BLOCK TOO BIG 



ERROR LU XX 



Cause 

Illegal request code 
or illegal parameter 
field within the 
request. 

On requests that 
require a block length 
field, the number 
requested is larger 
than the buffer area 
provided for it within 
the utility program. 

A read or write 
error was detected on 
logical unit XX. 



Action Taken By Program 

Message placed on the standard output 
unit, and then the program searches 
for the next request. 



Message placed on the standard output 
unit, and then the program searches 
for the next request. (The buffer 
lengths allowed by the utility program 
could be enlarged through reassembly.) 



The message is placed on the standard 
output unit. The program closes any 
unit opened for the request, and then 
searches for the next request. 



o 
o 

o 

o 
o 

o 
o 

© 

c 

© 

c 

o 
o 

c 

o 



3-8 



14063800 



© 



© 
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Error Message 




PICK NN LU XX 


o 




o 




© 


PACK NN LU XX 


© 




© 




© 


COMPARE ERR • 


RECORDS NN 



FILES MM 



© 

© 



© 
© 

© 



Cause 

Deblocker error 
number NN occurred 
on logical unit XX. 
R ef er to the blocker/ 
deblocker error 
codes for cause of 
this message. 

Blocker error number 
NN occurred on logical 
unit XX. Refer to the 
blocker/deblocker 
error codes for cause 
of this message. 

Compare error 
occurred on a verify 
request on record NN 
of the verify request, 
in the MMth file com- 
pared. (The record 
count is not restarted 
at the start of each 
new file compared. ) 



JOB STRUCTURE EXAMPLES 

UTIL job structure examples are as follows: 
• Card to print 
*JOB (...) 
*SCHED (...) 
*UTTL 

*T, 63, 62, , 1, S 
*OUT 
*EOJ 



Action Taken By Program 

The message is placed on the standard 
output unit. The program closes any 
units opened for the request and then 
searches for the next request. 



The message is placed on the standard 
output unit. The program closes any 
unit opened for the request and then 
searches for the next request. 



The message is placed on the standard 
output unit. The verify request con- 
tinues. (There is no way at present 
to limit the number of verify errors 
outputted on any verify request.) 
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o Card to tape (unblocked) 

*JOB (...) 

*SCHED (...) 

*EQUIP (30=MT) 

*UTIL 

*T,63,30,,20,,1 

DATA 

*END FILE 

*EOF, 30, 1 

*OUT 

*EOJ 
o Disk to print 

*JOB (...) 

*SCHED (...) 

*OPEN (40...) 

*UTIL 

*T,40,62,100,1,D 

*OUT 

*EOJ 
o Disk to tape (with verify) 



*SCHED (...) 
*OPEN (...) 
*EQUIP (30=MT) 
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r 



o 



c 



*JOB (...) O 



o 
o 








o 




o 




© 


*UTIL ' 


f% 


*T, 41, 30, B, 480, 500,1 


o 


*REW,41 
*REW, 30 


o 


*V, 41, 30, B, 480, 500,1 


© 


*OUT 
*EOJ 


o 




o 





© 

© 

© 

© 

o 
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o 
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o 
o 

© LOAD FILE EDITOR (COPYLj 

O 

o 
c 



D 

© 



The load file editor package enables the user to do the following: 

• Maintain program load files in the form of relocatable binary records 

• Eeplace existing subroutine modules with new binary load modules 

• Add new subroutine binary load modules to the load file 

The load file editor is called by the MPX/RT job processor upon reading a *COPYL 
statement from the standard input device. Only one copy/edit operation is allowed per 
*COPYL statement. 

CONTROL STATEMENT PROCESSED BY LOAD FILE EDITOR 

The control statement and its functions are as follows: 

*COPYL (U1.U2.U3) 

The parameters are as follows (logical unit numbers of a file can consist of magnetic 
tape or disk): 

• Ul Logical unit number of an existing load file 



^J 9 U2 Logical unit number of a file that contains subroutine binary 

modules to be replaced or inserted on the new load file 

■J • U3 Logical unit number of the updated load file 

Q GENERATE NEW LOAD FILE 

^"^ Selected subprogram binary modules may be replaced or inserted on a load file using an 

existing load file and an update binary file. The update file would typically be produced 
4Rk by preceding assemblies or compiles. 

W 
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o 
o 

All files are initially rewound, and subroutine binary module names are extracted from U2. #\ 

A copy operation of Ul to U3 is then performed, replacing those subroutine binary modules ^J 

specified on U2 on the new load file U3. The modules on U2 need not be in order. If 

modules on U2 are not included on Ul, they are inserted at the end of the new load file. g"Y 

Subroutine binary modules are read from Ul until an end-of-file is encountered. All ^J 

files must be in MPX standard blocking format, with a block size of 480 words. At the 

completion of the copy operation, files Ul and U3 are not rewound; file U2 is rewound. f\ 

A listing of the contents of the new load file is produced on standard output in the 

following format: f\ 



DECKS LISTED IN ORDER OF THEIR OCCURRENCE ON THE NEW BINARY FILE 

R DECKNAME INDICATES REPLACED DECK 

A DECKNAME INDICATES ADDED DECK 
Name 1 Name 2 Name 3 



**** COPYL COMPLETED**** 
GENERATE NEW LOAD FILE EXAMPLE 

The following example of a card deck illustrates the use of COPYL to generate a new 
load file from an existing load file, replacing selected subroutine binary modules. 

*JOB (ID=UPDATE) 

*SCHED 

*OPEN (10,BINARY-LGO,01,****,R) 

*ALLOCATE (BINARY-LGO, JFS, 02, ****, 480, 1000.RW, 2, SYSTEM01) 

*OPEN(20, BINARY-LGO, JFS, 02, ****,RW) 

*CMP(I,L,X) 



source decks 



*FTN(I,L,X) 



source decks 



o 
o 

© 



c 

c 



o 



o 
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o 



#* *COPYL(10,57,20) replacement modules on LGO 

*CLOSE(10) 
^ *CLOSE(20) 

Q *RELEASE(BTNARY-LGO,JFS,02,****,R) 



© 
o 

© 
© 






*EOJ 



COPYL ERROR MESSAGES 

Error Message Cause Action Taken By Program 

ERROR ON COPYL Illegal parameters Message placed on the standard 

CONTROL CARD on card. output unit. Files remain in 

their current position. MPX gets 
control and searches for the next 
request. 

The following errors are detected in the BLOCKER/DEBLOCKER programs, which pass 
the error code to COPYL where they are outputted to the standard output device. 

**** LOGICAL UNIT XX BLOCKER/DEBLOCKER ERROR AS FOLLOWS: 

On this line one of the following error messages will be placed. 

• EOF OR REACHED ALLOC. LIMITS 

• LOGICAL UNIT IS NOT OPEN 

• WRITE ATTEMPTED ON A READ ONLY FILE 

• BUFFER AREA ALREADY DEFINED 

• BUFFER SIZE TOO LARGE 

• BUFFER SIZE TOO SMALL 

• BUFFER AREA NOT DEFINED 

• RECORD SIZE LARGER THAN BUFFER SIZE 
t BUFFER AREA ALREADY DEFINED 

• CANNOT PERFORM SPECIFIED FUNCTION 
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• LOGICAL UNIT INVALID 

• IRRECOVERABLE I/O ERROR 

• BLOCK POINTER OUT OF BOUNDS 
Action taken by the program is same as that described previously. f\ 
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FILE CATALOG LISTING (CATLIST) 



The file catalog listing routine enables the user to produce a list of files within the mass 
storage system. This list is sorted into order by file owner. The list may be restricted 
to selected file owners or to selected disk devices. 

CONTROL STATEMENT PROCESSED BY CATLIST 

The control statement and its functions are as follow: 

*CATIIST (L=X, OX, U=X/X. . .X/X, P=X/X. . .X/XK-CATAK) 
The parameters are as follow: 

L=X 



o=x 



X specifies the logical unit number which is to receive 
the listing output. If omitted, logical unit 62 is used. 

X specifies the format of the output listing. 

Entry Indicates 



S 
N 
E 



Short format 
Normal format 
Extended format 



U-X/X...X/X 



P=X/X...X/X 



K=CATAK 



If omitted, short format is used. 

Each X consists of 1 to 4 characters specifying a 
file owner to appear on the output listing. The 
file owners must be spearated by the character /. 
If omitted, files of all owners are listed. 

Each X consists of 1 to 8 characters specifying 
a device label to appear on the output listing. 
The device labels must be separated by the 
character /. 

If omitted, files on all devices are listed. 

The appearance of this parameter enables the 
access keys of all files to be listed. CATAK 
is an installation parameter. If omitted or if 
CATAK is specified incorrectly, the access 
keys are not listed. 



n 
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CATLIST OUTPUT 

The CATLIST output listing contains all information stored in the system label file. The 
columns headings are as follow: 

LBN Block number of the label in the label file 

OWNER Identity of the owner of the file 

FILE NAME Identifies the file 

ED Edition number which identifies different 

versions of the file 

CR-DATE Creation date 

LU-DATE Last used date 

DU-DATE Last dumped date 

ALLO Number of blocks allocated to the file 

USED Number of blocks used by the file 

SIZE Number of words per block. . 

SECT Number of sectors per block 

SC Number of segments in the file 

TYPE Device type on which this segment resides 

DEVICE ID Identification of the devices on which this segment 

resides 

LSL Lower sector address: sector address at which 

this segment begins 

SL Segment length: number of sectors in this segment 



o 
o 
o 
o 

« 

o 
o 

© 

G 
C 

o 

c 
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♦CATLIST (U=MPXL/MPXR) 





CATALOG FILI 


: LISTING ON 10/12/79 AT 


13/24/15 




PAGE 1 




LBN 


OWNER 


FILE NAME 


ED 


CR-DATE 


LU-DATE 


DU-DATE 


3 


MPXL 


MPX- LIBRARY 


20 




10 9 79 




8 


MPXL 


MPX-LIBRARY 


21 


10 9 79 


10 12 79 




322 


MPXL 


MPX- LIBRARY 


22 


10 11 79 


65 65 65 




23Q 


MPXL 


MPX-LIBRARY 


BW 


10 9 79 


10 9 79 




248 


MPXR 


MPX-RESIDENT 


01 


10 12 79 


10 12 79 


10 12 79 


2 


MPXR 


MPX-RESIDENT 


17 








9 


MPXR 


MPX-RESIDENT 


18 


10 12 79 


10 12 79 




252 


MPXR 


MPX-RESIDENT 


CE 


10 11 79 


10 12 79 


10 12 79 


247 


MPXR 


MPX-RESIDENT 


CN 


10 11 79 


10 12 79 


10 12 79 


275 


MPXR 


MPX-RESIDENT 


CP 


10 11 79 


10 12 79 


1Q 12 79 


10 


MPXR 


MPX-RESIDENT 


NU 


10 9 79 


10 9 79 





*CATLIST (0=S,U=SAVE) 
CATALOG FILE LISTING ON 10/12/79 AT 13/23/46 

LBN OWNER 

134 SAVE 
40 SAVE 
36 SAVE 

132 SAVE 
35 SAVE 

136 SAVE 

39 SAVE 

4 SAVE 

130 SAVE 

127 SAVE 

131 SAVE 
267 SAVE 
259 SAVE 
129 SAVE 

135 SAVE 

128 SAVE 

133 SAVE 



FILE NAME 


ED 


ASMBACK 


00 


BATCH-DEFAULT 


00 


CATLIST 


00 


DELFILE 


00 


EDIT 


00 


HELP 


00 


JOB- 


00 


LABBACK 


00 


LABBKG 


00 


LOAD 


00 


LOAD. JOB 


00 


POSBKGND 


po 


POSBKGNP 


00 


PRINT 


00 


RELEGAY 


00 


T66-SAV1 


00 


T66-SAV2 


00 
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CR-DATE 


LU- 


DATE 


DU-DATE 


10 9 79 


10 


11 


79 


10 11 79 


10 11 79 


10 


11 


79 


10 11 79 


10 H 79 


10 


12 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 11 79 


10 


12 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 11 79 


10 


11 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 U 79 


10 9 79 


10 


11 


79 


10 11 79 


10 12 79 


10 


12 


79 


10 12 79 


lO 12 79 


10 


12 


79 


1Q 12 79 


10 9 79 


10 


12 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 


10 9 79 


10 


11 


79 


10 11 79 
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